Public TSG (2601): SBE Update fails with "Cannot validate argument on parameter 'DeployADLess'" #240
Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds a new troubleshooting guide for SBE updates failing on 2601 due to the DeployADLess parameter issue and wires it into the Update TSG index. It documents the scenario, root cause, and provides a PowerShell mitigation script to add the missing CloudParameters entry.
Changes:
- Introduced
SBE-Update-Fails-with-Cannot-Validate-Argument-on-Parameter-DeployADLess.mddescribing the 2601 SBE update failure, its root cause, and a corrective script to add theDeployADLessparameter. - Updated
TSG/Update/README.mdto include the new TSG entry and fix the formatting of the preceding 2509 entry.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
TSG/Update/SBE-Update-Fails-with-Cannot-Validate-Argument-on-Parameter-DeployADLess.md |
New TSG describing the DeployADLess validation failure on 2601 and providing a PowerShell script to add the missing CloudParameters entry safely and idempotently. |
TSG/Update/README.md |
Adds a link to the new SBE DeployADLess TSG and normalizes the formatting of the existing 2509 entry in the Update TSG list. |
|
|
||
| DeployADLess parameter entry was introduced in version 2408, but is only applicable to clusters deployed on this version or later. For earlier clusters, update process did not insert the entry to CloudParameters. | ||
|
|
||
| 2601 introduced some new SBE scripts that depends on the value of this parameter. In the absence of the parameter, the value becomes the placeholder literal string '[DEPLOYADLESS]'. This value is unexpected by the script and thus fails the update. |
There was a problem hiding this comment.
In the sentence "2601 introduced some new SBE scripts that depends on the value of this parameter.", the subject is plural ("scripts"), so the verb should also be plural ("depend") for correct grammar and clearer reading.
| 2601 introduced some new SBE scripts that depends on the value of this parameter. In the absence of the parameter, the value becomes the placeholder literal string '[DEPLOYADLESS]'. This value is unexpected by the script and thus fails the update. | |
| 2601 introduced some new SBE scripts that depend on the value of this parameter. In the absence of the parameter, the value becomes the placeholder literal string '[DEPLOYADLESS]'. This value is unexpected by the script and thus fails the update. |
| "@ | ||
| $null = $eceClient.UpdateCloudParameters($parametersUpdateDefinition).GetAwaiter().GetResult() | ||
| Write-Output "Validating add DeployADLess parameter" | ||
| $null = $ececlient.InvalidateCloudDefinitionCache().GetAwaiter().GetResult() |
There was a problem hiding this comment.
The variable is declared as $eceClient earlier in the script but referenced here as $ececlient with different casing; while PowerShell variable names are case-insensitive, using consistent casing improves readability and avoids confusion when scanning for variable usages.
| $null = $ececlient.InvalidateCloudDefinitionCache().GetAwaiter().GetResult() | |
| $null = $eceClient.InvalidateCloudDefinitionCache().GetAwaiter().GetResult() |
1 participant
No description provided.